Fix some GObject introspection annotations

Fixes several warnings by the GIR compiler.

diff --git a/gdk/x11/gdksurface-x11.c b/gdk/x11/gdksurface-x11.c
index f792cd00613362871b7728e20d4093f97531e07c..f4ecd5d2f8ea22204af37c7fc3a43873c38a2c32 100644 (file)
--- a/gdk/x11/gdksurface-x11.c
+++ b/gdk/x11/gdksurface-x11.c
@@ -3317,6 +3317,14 @@ gdk_x11_surface_set_keep_below (GdkSurface *surface, gboolean setting)
                                 setting ? GDK_SURFACE_STATE_BELOW : 0);
 }
 
+/**
+ * gdk_x11_surface_get_group:
+ * @surface: The #GdkSurface
+ *
+ * Returns the group this surface belongs to.
+ *
+ * Returns: (transfer none): The group of this surface;
+ */
 GdkSurface *
 gdk_x11_surface_get_group (GdkSurface *surface)
 {

diff --git a/gsk/gskrendernode.c b/gsk/gskrendernode.c
index b19396c961945baea945b701d77ef289a3c75e9d..781eb797d1e820117424a926645679388a51fc42 100644 (file)
--- a/gsk/gskrendernode.c
+++ b/gsk/gskrendernode.c
@@ -350,7 +350,8 @@ gsk_render_node_write_to_file (GskRenderNode *node,
 /**
  * gsk_render_node_deserialize:
  * @bytes: the bytes containing the data
- * @error: (allow-none): location to store error or %NULL
+ * @error_func: (nullable) (scope call): Callback on parsing errors or %NULL
+ * @user_data: (closure error_func): user_data for @error_func
  *
  * Loads data previously created via gsk_render_node_serialize(). For a
  * discussion of the supported format, see that function.

diff --git a/gsk/gskrendernodeimpl.c b/gsk/gskrendernodeimpl.c
index 32e5d57827c0886693b7e1beae10fd2018b34e2b..0a432306ee291ae1f45755aa2d208fc6c6c8a21d 100644 (file)
--- a/gsk/gskrendernodeimpl.c
+++ b/gsk/gskrendernodeimpl.c
@@ -3556,6 +3556,14 @@ gsk_text_node_peek_color (GskRenderNode *node)
   return &self->color;
 }
 
+/**
+ * gsk_text_node_peek_font:
+ * @node: The #GskRenderNode
+ *
+ * Returns the font used by the text node.
+ *
+ * Returns: (transfer none): The used #PangoFont.
+ */
 PangoFont *
 gsk_text_node_peek_font (GskRenderNode *node)
 {

diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c
index d1b061840697b8470ea51c5fb561cb39ddd46e34..485e46dacc9ddeb0c4ef50f495a3a97334856694 100644 (file)
--- a/gtk/gtkmenubutton.c
+++ b/gtk/gtkmenubutton.c
@@ -1306,7 +1306,7 @@ gtk_menu_button_get_icon_name (GtkMenuButton *menu_button)
 /**
  * gtk_menu_button_set_label:
  * @menu_button: a #GtkMenuButton
- * @icon_name: the label
+ * @label: the label
  *
  * Sets the label to show inside the menu button.
  */

diff --git a/gtk/gtknative.c b/gtk/gtknative.c
index 5b8f760349f9a9ec08cf1091e640103c4100f1c1..a14a0af864131976e7d8a0c07769555647530139 100644 (file)
--- a/gtk/gtknative.c
+++ b/gtk/gtknative.c
@@ -74,7 +74,7 @@ gtk_native_default_init (GtkNativeInterface *iface)
  *
  * Returns the surface of this #GtkNative.
  *
- * Returns: the surface of @self
+ * Returns: (transfer none): the surface of @self
  */
 GdkSurface *
 gtk_native_get_surface (GtkNative *self)
@@ -90,7 +90,7 @@ gtk_native_get_surface (GtkNative *self)
  *
  * Returns the renderer that is used for this #GtkNative.
  *
- * Returns: the renderer for @self
+ * Returns: (transfer none): the renderer for @self
  */
 GskRenderer *
 gtk_native_get_renderer (GtkNative *self)

diff --git a/gtk/gtkpopover.c b/gtk/gtkpopover.c
index 73005e92f71f9b160671930e897bce0b81a2bb02..d1fdd73218bf145a0389bc3ea6b563b9c7f792c5 100644 (file)
--- a/gtk/gtkpopover.c
+++ b/gtk/gtkpopover.c
@@ -1395,6 +1395,13 @@ size_changed (GtkWidget   *widget,
     gtk_popover_move_resize (popover);
 }
 
+/**
+ * gtk_popover_get_popovers:
+ *
+ * Returns the list of all existing #GtkPopover widgets.
+ *
+ * Returns: (transfer none): The list of existing popovers.
+ */
 GListModel *
 gtk_popover_get_popovers (void)
 {

diff --git a/gtk/gtkroot.h b/gtk/gtkroot.h
index 648defa380948f8007b5d80f8236ddb1fcc1d862..c147c09ff022cf70e76d93bd6ce20bd5b3133067 100644 (file)
--- a/gtk/gtkroot.h
+++ b/gtk/gtkroot.h
@@ -49,7 +49,7 @@ struct _GtkRootInterface
 };
 
 GDK_AVAILABLE_IN_ALL
-GdkDisplay * gtk_root_get_display (GtkRoot *root);
+GdkDisplay * gtk_root_get_display (GtkRoot *self);
 
 GDK_AVAILABLE_IN_ALL
 void        gtk_root_set_focus (GtkRoot   *self,